home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 622 / grocery / grocery.txt < prev    next >
Text File  |  1992-06-20  |  10KB  |  209 lines
  1.                             Grocery Lister
  2.      
  3.                              Version 1.8
  4.                              October 1991
  5.  
  6.                           by Randy Hoekstra
  7.                              Public Domain
  8.                     All Commercial Rights Reserved
  9.  
  10.  
  11.      * Changes for version 1.8:
  12.        - This version primarily fixes a bug which would not allow
  13.        the total cost of the grocery list to exceed $99.99.  A few
  14.        other almost unnoticable cosmetic changes were also made.
  15.      * Changes for version 1.7:
  16.        - The Current Grocery List window has been changed so that 
  17.        the grocery list is now displayed in a single column with the 
  18.        entire grocery item visable.  It is also possible to select 
  19.        this window and scroll through the grocery list using the 
  20.        window scroll arrows and slider bar.
  21.      * Changes for version 1.6:
  22.        - The Add, Edit, and Delete Grocery Item dialogs have been 
  23.        changed to conform more to the GEM standard.  Now when 
  24.        entering a new item, use tab or return to move from the 
  25.        text field to the price field.
  26.        - The Open and Save Grocery File functions have been 
  27.        rewritten and greatly sped up.  As a result of this change, 
  28.        the disk file format of the grocery file has changed.  
  29.        Included in the archive is a conversion program (GLD_CONV) 
  30.        to convert your existing grocery file to the new format.
  31.      * Changes for version 1.5:
  32.          The primary features added with version 1.5 are command key 
  33.        equivalents, a sort grocery list command, and a 'jump to 
  34.        letter' in the grocery file function.  Command key equivalents 
  35.        are shown in the menu to the right of the corresponding 
  36.        command.  The sort grocery list command appears under the file 
  37.        menu and is described below.  The 'jump to letter' feature 
  38.        allows you to press a key A through Z and jump to the position 
  39.        in the grocery file where grocery items beginning with that 
  40.        letter start.
  41.      ----------------------------------------------------------------
  42.       
  43.        Grocery Lister is a household utility program that allows you to 
  44.      compile a list of grocery items complete with current price and 
  45.      total estimated cost.  The Grocery Lister can be used to determine 
  46.      approximately how much you will spend at the store if you know the 
  47.      items that you need.  It can also be used as a budget tool to 
  48.      allow you to select the items you most need or want if you only 
  49.      have a fixed amount to spend.  With a small amount of database 
  50.      maintenance work each time you buy groceries you will be able to 
  51.      maintain a fairly accurate file of the items which you regularly 
  52.      purchase.  This file can be very usefull to remind you of items 
  53.      which you may need as you compile your grocery list.  Finally, for 
  54.      those who have 'errand boys' do the shopping, the Grocery Lister 
  55.      will generate a very neat and easy to read printout of the current 
  56.      grocery list.
  57.  
  58.  
  59.  
  60.        To put Grocery Lister to work for you, simply run the program 
  61.      and use the simple menu commands as explained on the following
  62.      pages.
  63.      
  64.      
  65.      FILE
  66.      ----
  67.           Open Grocery File ^O - Use this command to load a grocery
  68.           --------------------   database file into memory.  Once 
  69.           loaded the file may be used to select items for a 
  70.           current grocery list or it may be edited as desired.  
  71.           Grocery items can be add to a current grocery list by 
  72.           moving the mouse pointer over the desired item so that 
  73.           it is highlighted and pressing the left mouse button.  
  74.           To increase the quantity of a given item in the current 
  75.           grocery list, simply click the left mouse button on the 
  76.           highlighted item to add one to the current quantity 
  77.           shown.  Click the right mouse button on the highlighted 
  78.           item to subtract one from the current quantity in the 
  79.           list.  A maximum quantity of nine is allowed for any 
  80.           given grocery list item.
  81.  
  82.           Note:  If a grocery list had been previously saved for 
  83.           the grocery file being loaded, then that list will also 
  84.           be loaded into memory.
  85.  
  86.           Save Grocery File ^S - Once changes have been made to a
  87.           --------------------   grocery file in memory, use this 
  88.           command to save a copy of the updated grocery file on 
  89.           disk.  If a grocery list existed on disk when the file 
  90.           was loaded, then it will be updated on disk when the 
  91.           file is saved.  The grocery list will remain saved on 
  92.           disk until it is deleted as described under 'Delete 
  93.           Saved List'.
  94.  
  95.           Save Grocery List ^L - The current grocery list in memory
  96.           --------------------   can be saved to disk with this 
  97.           command.  Since the grocery file in memory and the 
  98.           current list in memory are dependant on each other, the 
  99.           grocery file in memory must be saved to disk before a 
  100.           grocery list can be saved to disk.  If no changes are 
  101.           made to a grocery file after it is loaded into memory, 
  102.           then a current list may be saved to disk at any time.  
  103.           As noted above, when a list is saved on disk, it will 
  104.           automatically be loaded into memory when its grocery 
  105.           file is loaded.  Grocery files and their grocery list 
  106.           must remain in the same disk directory.
  107.  
  108.           Delete Saved List -  Once a grocery list has been saved 
  109.           -----------------    on disk, it can be deleted with 
  110.           this command.  Again, the grocery file and grocery list 
  111.           are directly linked.  If a grocery list exists on disk 
  112.           then it will load into memory with its grocery file and 
  113.           will also be updated on the disk if its grocery file is 
  114.           changed and saved to disk.
  115.  
  116.  
  117.  
  118.           Sort Grocery List ^R - After items have been added to the
  119.           --------------------   grocery list, the list can be sorted 
  120.           in ascending alphabetical order with this command.
  121.  
  122.           Quit ^Q - Exit the program.  A warning will be posted if
  123.           -------   any changes have been made to the grocery file 
  124.           allowing you to quit anyway or cancel the command.
  125.  
  126.  
  127.      EDIT
  128.      ----
  129.           Add Grocery Item ^A - This command will bring up a small
  130.           -------------------   edit window that will allow you to
  131.           type in a new grocery item and its price.  The item is put 
  132.           into the grocery file in alpabetical order.  The item is 
  133.           not checked to see if it is already in the file so it is 
  134.           possible to have duplicate items.  To enter the item, 
  135.           simply type in its name, return or tab over to the amount 
  136.           field, type in the price in the format shown  on the input 
  137.           line, and press return.  The item will be entered into 
  138.           the file and the input line will be cleared so that 
  139.           another entry can be made.  When finished entering new 
  140.           items, press return on a blank input line to quit out of 
  141.           the edit window.
  142.  
  143.           Note:  Once an item has been entered into the grocery 
  144.           file its name can not be changed.  If an items name 
  145.           needs to be changed, it must be deleted from the file 
  146.           and then added back again.
  147.  
  148.           Edit Grocery Item ^E -  This command is used to alter the
  149.           --------------------    price of an existing grocery item.  
  150.           To change an items price, move the mouse pointer over 
  151.           the desired item so that it is highlighted and then 
  152.           select the Edit Grocery Item command.  Be sure that the 
  153.           desired item remains highlighted when the command is 
  154.           selected.  The item will be placed in the edit window 
  155.           with the cursor positioned at the amount input field.  
  156.           Enter the new price in the format shown on the 
  157.           input line and press return.  The edit window will be 
  158.           closed and the new price will be updated in the grocery 
  159.           file.
  160.  
  161.           Delete Item ^D -  Use this command to remove unwanted items 
  162.           --------------    from the grocery file.  Position the 
  163.           mouse pointer over the item to be deleted and then 
  164.           select this command from the menu line.  Be sure that 
  165.           the desired item remains highlighted when the command is 
  166.           selected.  The item will be placed in the edit window 
  167.           and you will be asked to verify the delete operation.  
  168.           Type a 'Y' to confirm the delete or an 'N' to cancel the 
  169.           command.  The left mouse button may also be pressed to 
  170.           confirm the delete and the right mouse button may be 
  171.           used to cancel the command.
  172.  
  173.  
  174.  
  175.  
  176.           Clear All ^C - This command can be used to clear both the
  177.           ------------   grocery file and grocery list out of current 
  178.           memory. If changes have been made to the grocery file or 
  179.           grocery list they will be lost.  This command does not 
  180.           effect files saved on disk.
  181.  
  182.  
  183.      Print
  184.      -----
  185.           Print Grocery File - Use this command to print out the
  186.           ------------------   current grocery file in memory.  The 
  187.           file will be printed in continous form with no page 
  188.           breaks.
  189.  
  190.           Print Grocery List ^P- Use this command to print out the
  191.           ---------------------   current grocery list in memory.
  192.           The list will be printed in continous form with no page 
  193.           breaks.  The printout from this command can be used as a 
  194.           shopping list and to mark changes in prices while buying 
  195.           groceries.
  196.  
  197.      Grocery Lister may be freely distributed provided no changes are 
  198.      made to the program or the documentation.  This user manual must 
  199.      be included with the program if it is to be placed in any public 
  200.      access medium.
  201.  
  202.  
  203.      Please send bug reports and/or comments to:
  204.  
  205.      Randy Hoekstra
  206.      3414 Norwood Circle
  207.      Richardson, Texas  75082
  208.  
  209.